home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / onlinediag.z / onlinediag
Encoding:
Text File  |  2002-10-03  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. oooonnnnlllliiiinnnneeeeddddiiiiaaaagggg((((1111MMMM))))                                                  oooonnnnlllliiiinnnneeeeddddiiiiaaaagggg((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      onlinediag - run diagnostic tests on cpus to test floating point units.
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      oooonnnnlllliiiinnnneeeeddddiiiiaaaagggg [----pppp procnum] [----cccc config] [----llll logfile] [----rrrrddddkkkkffff]
  13.           [----PPPP priority]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _o_n_l_i_n_e_d_i_a_g runs diagnostic tests on cpus to test floating point units.
  17.      It reads the full path names of binaries out of a config file (default of
  18.      /etc/config/onlinediag.config) and reports failures of these tests in the
  19.      /var/adm/SYSLOG.  The output of the test binaries are saved in the log
  20.      file (default of /var/adm/onlinediag.logfile) if there are any failures
  21.      or the tests fail to run for some reason.
  22.  
  23.      The ----pppp _p_r_o_c_n_u_m parameter indicates what processor the test will run on.
  24.      If no value is specified, the program will run the test binaries on each
  25.      processor in turn.
  26.  
  27.      The ----cccc _c_o_n_f_i_g parameter indicates the config file that lists the binaries
  28.      to run.  The config file must have the full path name of the test
  29.      binaries.  All characters after a '#' in a line are ignored.  The parsing
  30.      is very simple and cannot deal with quotes.  The maximum number of test
  31.      binaries allowed is 64.  The default config file is
  32.      /etc/config/onlinediag.config.
  33.  
  34.      The ----llll _l_o_g_f_i_l_e parameter indicates the logfile name that the output of
  35.      binaries should be placed.  The default logfile is
  36.      /var/adm/onlinediag.logfile.
  37.  
  38.      The ----rrrr parameter indicates that onlinediag should restrict any cpu that
  39.      fails the test binaries.  Normally onlinediag simply logs the failure in
  40.      /var/adm/SYSLOG and does not restrict the cpu.
  41.  
  42.      The ----dddd parameter indicates that onlinediag should disable on the next
  43.      reboot any cpu that fails the test binaries.  Normally onlinediag simply
  44.      logs the failure in /var/adm/SYSLOG and does not disable the cpu.
  45.  
  46.      The ----kkkk parameter indicates that onlinediag should keep the logfile
  47.      regardless of failures of the test binaries.  Normally onlinediag throws
  48.      out the logfile if nothing goes wrong.
  49.  
  50.      The ----ffff parameter indicates that onlinediag should run on all enabled
  51.      cpus, including those that are restricted or isolated.  Normally
  52.      onlinediag does not run on restricted or isolated cpus.
  53.  
  54.      The ----PPPP _p_r_i_o_r_i_t_y parameter indicates the priority onlinediag will be run
  55.      at.  The value can be in the range -20 to 20 with -20 being the highest
  56.      priority and 20 being the lowest.  The priority defaults to 10.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. oooonnnnlllliiiinnnneeeeddddiiiiaaaagggg((((1111MMMM))))                                                  oooonnnnlllliiiinnnneeeeddddiiiiaaaagggg((((1111MMMM))))
  71.  
  72.  
  73.  
  74. OOOOVVVVEEEERRRRVVVVIIIIEEEEWWWW
  75.      _o_n_l_i_n_e_d_i_a_g runs test binaries on different processors.  The test binaries
  76.      specifically test the floating point unit.  The kernel uses only the
  77.      integer unit and therefore, a malfunctioning floating point unit can go
  78.      undetected, perhaps giving incorrect results, for long periods of time.
  79.      onlinediag provides a means of detecting a malfunctioning floating point
  80.      unit in a timely fashion so it can be replaced.
  81.  
  82.      _o_n_l_i_n_e_d_i_a_g runs as a cron job of the diag user at very low priority by
  83.      default.  The crontab of the diag user should be changed using the
  84.      _d_i_a_g_s_e_t_u_p script.  Use this script to turn off onlinediag as well as to
  85.      control when it is run.  This script also controls the turning on and off
  86.      of _c_a_c_h_e_d. cached also runs as a cron job of the diag user.
  87.  
  88.  
  89.  
  90. FFFFIIIILLLLEEEESSSS
  91.      /usr/diags                 the diag user's home directory
  92.      /usr/diags/bin/onlinediag  location of onlinediag executable
  93.      /etc/config/onlinediag.config
  94.                                 default config file
  95.      /var/adm/onlinediag.logfile
  96.                                 default logfile
  97.      /usr/diags/bin/diagsetup   script to control the periodic running of
  98.                                 onlinediag and cached
  99.  
  100.  
  101.  
  102. NNNNOOOOTTTTEEEESSSS
  103.      To avoid disruptions to real-time usage, onlinediag normally does not run
  104.      on isolated or restricted cpus. This can be overridden by using the -f
  105.      flag.
  106.  
  107.  
  108.  
  109. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  110.      cached(1M), diagsetup(1M)
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.